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This paper represents the beginning of a theitpful hints on how to 
do your job's document. Some of the areas discussed are still 
incompfete. [ will be periodically adding information to the 
documente If you have any qustions or suggestionss please see 
Tom McGee. Appendix A Fists background documents and how to 
obtain then, 


Update History 

Date Changes 

2/8730 Section 3.0 revised 

2/12/80 Appendix A Section 3.3 corrected 

2713/80 Section 1.0 revised 

9/11780 Section 3252223 reviseds Section 3245222824 added 


12722/80 Revisions for NOS/VE Phase C 
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1.0 DUAL STATE NOS/VE DEADSTART 


1.0 QUAL_STATE_NOSZVE_DEADSTART 


1.1 ALZO_NOIS_QDEADS TART 

0 The system is configured to run with three FMD units (41s 42 
and 43). No 844 drives are needed. 

o Set the D/5 panel to deadstart from the primary system disk. 

0 Push D/S button 

o Setect "0" display 

o Select. "H" display 

o Enter C4%=10000 

0 Enter (CR) 
Enter date/time 
Wait for deadstart to complete 

Note: The deadstart tape which matches this A170 NOS system is 


found in the tape cabinet back by the curtainss where all the. 
other Integration tapes are kepts !tabeted DUALOM,. 


1.2 CURRENT QUAL STATE _CONEIGURATION 


o FMD Unit 43 
This unit contains the following: 


- A170 NOS (Build 4 fevel)ds, CTI» CMSEs EI binariess NOS 
deadstart files 

~ Files associated with user number LIBRARY 

~- Files associated with user number SES 

- Files associated with DEV1ls RELI» INT1. 


o FMD Unit 41 


-~ A170 NOS (Build 6 tJevelt)ds CTI» MSL» EI binariess, NOS 
deadstart file 
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1.0 DUAL STATE- NOS/VE- DEADSTART 
1.2 CURRENT DUAL STATE CONFIGURATION 


: 
FE 


T 


—_ 


his is a scratch unit 
MD Unit 42 
his unit contains the following: 


NOS/VE Development Area PL*s and Member PL'*s 

NOS/VE Deadstart Files to be tested (saved in individual. 
user's catalogs) 

Files associated with user number INT2 


163 QUAL_STATEs NOS_OPERATION 


1) 


2) 


The convention used for creating user numbers on NOS/VE is 
as Follows? 


o Your user number will be your initials. 

o Your password will be these 3 letters followed by the 
letter '%x?, 

0 You must see COMSGURCE (RK. Cooper —- x3092) to be 
assigned a user index 


User numbers are created by executing the program "MODVAL™ as 
follows: 


o Type *X.MOOVAL". 

o Type "Kym." where m is the MODVAL contro! point 

o Type "K.~C»suuu.”" where uuu = your user numbers. Note that 
the "X." stays on the screen. 

0 Type "K.PW=uuuxXs FUI2zn." where n = your user index 

0 Set aii other parameters to their maximum values. Do a 
#+" to see next page - there are 3 pages associated with a 
user Numbers 

o0 Type "KeEND»”™ to end creation of that user number. 
Another user number may now be created. 

o Type "KeENDs” again to exit MODVAL. 


PF dumping and toading 


You may use "SESsDUMPPF™ on SN/101 to dump your permanent 
fies to tapes and then toad them onto your user naumber = on 
A170 NQS using “"SES.~LOADPF", Documentation on how to use 
these SES procedure and what their parameters are is included 
in the SES "User's Guides or they can be obtained by typing? 


"SESsHELP»DUMPPF™ and “SESsHELP»LGADPF"™. 
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1.90 DUAL STATE NOS/VE DEADSTART 
1.4 NOS/VE DEADSTART 


1.64 NOSZVE_DEADSTART 


The following file must be available in your catalog on the 
$23 


TPXXXK contains a NOS/VE deadstart image. This must be a copy 
of the dual state deadstart images available from the link 
procedures: 


CIMAGEs PPIMAGEs RGIMAGE are "fast" filess which are built 
From TPXXXK the First time you deadstart NOS/VE. These files 
are then used on subsequent deadstart attempts. Before a new 
TPXXXK can be useds these "Fast™® Files must be purged off your 
user nunber. 


Mount the disk tabeted “"“DAHL-Large sector" on 844 unit 0 
(other disks wift not work). The default disk driver for 
build M is the NOS/VE driver. 


Type the following: 


XeDIS. 

JSERsscatsscatx.ewhere scat = INTL or INT2 
CALL» SYEDNVE. 

DROP. 


Bring up dual state? 

XeUPMYVE: (CAT2mycats DEVL=scat) 

where mycat = user catalog (as before) 
scat = system ctalog ~ INT2 or INTL 

The UPMYVE job will dispiay the following: 

REQUEST *<X* DISPLAY on the 8B display 


Type Keene where n is the control point number of the UPMYVE 
job. 


125 NOSZVE_ TERMINATION 


1c) 


Bringing down dual. state: 


Ke*¥BYEVEs 
Ke *ENDRUN 
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1.6 BRING UP C170 REMOTE HOST 


1.56 BRING JP_C€170_ REMOTE YOST 


Type 
TAFNVE* 


Control point two must be free or rolioutable (i.ee.» NAM should 
not be there). This aiso brings up PASSGN and the MLI subsystem 
control points. 


If either (or both) IRHF170 or PASSON abort or are dropped by the 
operators they can be brought up by entering: 


XeTRHF170.: 
or 
XePASSON. 


if TAF is still at control point two. If TAF has aborted, then 
the TAFNVE. command must be used. 


1.7 BRING JP_€180_ REMOTE YOaT 


Type 


Keane where n is the UPMYVE control. point number, 
KeEXECUTE ss 9959 RHPSINPUTs TASK _ NAME@As 
KeEXECUTE ss »ssRHPSOUTPUTs TASK NAME=B- 


Note? To enter $3 at the consoles type/% 
To enter at the consoles typesO 


1.7.1 ROUTE AN INPUT FILE FROM C170 TO C180 


Through the systen consoles enter: 
Type 


XeDIS. 
USER»sAs8. 
GET,»filenaneswhere filename 
identifies the input file to 
be routed. 
ROUTEsfilenanesDC=LPy,FCzRH. 


If you are running from an interactive terminals enter? 
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GET» Filenane. 
ROUTEsfilenamesDC=LP,FC=RH, 


The input file which is sent to the 180 must be in 6/12 ASCII. 
{or display code subset).. The job file must be a single 
Partition 170 record containing NOS/VE commands.» Multi partition 
input files are not yet supported by NOS/VE so 170 data (files 
used by the program must be obtained through the NOS/VE permanent 
file GET command. The tast command of the job file must be 
JMEXIT in order to cause the job to terminate properly. 


1.7.1.1 Route _A_ Print File From. C180 to C170 


At NOS/VE job termination the job tog (dayfile) will be 
automatically returned to the 170. The job log will be appended 
to the NOS/VE output file OUTPUT. NOS/VE print files must be 
written by BAM as 8/8 ASCII RT#W. Print files will be converted 
From 878 ASCII. R2T=W to Display Code (64 character set —- upper 
case only) when they are sent to the 170. Support for ASCII 
print files (8712 ASCII) will be added at a later buitd. All 
NOS/VE output files will appear in the 170 output queue (NOS HsO 
display) with the name IRHFxxx as a banner. In order to route a 
NBS/VE print file to the 170s the following command must be 
contained in the 180 job file or be entered from the system 
cansole via the K display? 


JMROUTEs jobnamesfilenamesPR»sREMOTE 


jobname - name that the print file will have in the 180 
output queue. 


filename - name of the tocal 180 file created by BAM that is 
to be printed. 


PR —- specifies that the file is a print file (must always be 
PR). 


REMOTE - name of the 180 family for the print file (must 
always be REMOTE). The NGS command language must be in 
HOS mode (HCS command) in order to enter the JMROUTE 
command. 


Example of JMROUTE command: 
JMROUTEsLISTINGsLINKMAPsPR»sREMOTE. 
On the Ci70O sides the printer must be physically and 


logically on. To logically turn the printer ons under 
DSD enters: 
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1.70121 Route A Print File From C180 to C170 


ON32. 
FIRM329TM. 


1e7e1l.2 LINK_-USER Command 


In order to access C170 permanent files from a C180 jobs the 
NOS/VE. job must issue a LINK_LUSER commande. The LINK_USER command 
specifies the user identification on the 170 under which C170 
permanent files wifi be accessed. 


The following must be done to enter the LINK_USER command? 
LIUsUS2(usersFfamily)s PA=passwords Azaccounts, PReproject. 


The LIU (or LINK_USER) command specifies the NOS users family 
and password parameters which are used by IRHF170 to create 170 
jobs which access €170 permanent files» Ai! LINK_USER parameters 
are specified with keywords. The account and project parameters 
are not requied and not utilized. 


US or USER) - This parameter specifies the NOS user number 
(catalog) and famiity in which the 170 permanent files reside. 
tuser' will be the first parameter on the 170 job's USER card and 
'famiiy' will be the third parameter. Currentiy the only family 
on the $2 Dual State system is calied NVE. 


PA {or PASSWORD) This parameter specifies the password that 
is used to login to the user number, 'password’? wil! be 
the second parameter on the 170 job*s USER card. 


A or (ACCOUNT) This parameter specifies the account number 
{charge number) for the 170 job. It will be the first 
parameter on the 170 job's CHARGE card. 

PR or (PROJECT) This parameter specifies the project number 
for the 170 job. [t will be the second parameter on the 
170 job*s CHARGE card. 


Notes When running on the Simulators the LINK_USER command 
is not required to use the GET and REPLACE commands. 


Example of LINK_USER command: 


LIUsUS=(FABsNVE)» PA=FABX»s A=7136»% PR*73E08802. 
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1272123 Get_A_170. Permanent Eile Eron_13890 


The GET command obtains a copy of a permanent file residing on 
the 170. The 170 permanent file can be either a direct or an 
indirect access permanent file, The NOS/VE command processor 
must be in HOS mode (HCS command Issued) in order to use the GET 
command. Aili. parameters on the GET command are positional. Onty 
the tifn' parameter is required. <A LINK USER command must be 
issued (for the 170 fanily on which the permanent file resides) 
Prior to issuing the GET ccmmand. The format of the GET command 
is:. 


GETsifnspfnspwesunsfmscds 


ifn (focal fiite name) - This is the name of the tocal NOS/VE 
file to which the 170 permanent file will be transferred. 


pfn (permanent file name) - This is the name of the 170 
permanent file that is to be accessed. If this parameter is 
omitted then tifn! wiil be used for the 170 permanent File 
Names 


pw (password) - This is the password that wil! be used to 
access the 170 permanent file if a password is required to 
access the file on the 170. 


un fuser name) - This is the user name (alternate catalog) 
on which the 170 permanent file resides. 


Fm (family) - This is the family on which the 170 permanent 
file resides. Currently the onty 170 family on the S2 Dual 
State system is NVE. 


ca (conversion alternatives) - This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 170 to 180. If this parameter is omitted 
then a default of 860 will be assumed. Values for this 
parameter are: 


B60: Basic Biary 


The full 50 bits of each 170 word are transferred to the 
flower 60 bits of each 64 bit 180 word. The upper 4 bits 
of each 64 bit 180 word are set to 0O- The File is 
written to 180 using BAM with Block Type * System 
(Unblocked) and Record Type = Undefined ({(RT#U) so no 
control information is inserted in the File. The 170 
fogical record structure is dropped {i.e., EORS are 
deleted causing the togical records to be packed 
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together. 
B56:. C1890 Binary 


The lower 56 bits (7 8 bit bytes) of each 170 word are 
packed into contiguous 8 bit bytes on the 180 (iseee.,»s 7 8 
bit bytes from the first 170 word and 1 8 bit byte from 
the second 179 word go into the first 180 word etce). 
The 170 logical record structure (E0Rs) are dropped. 
The way that the 180 file which was transferred from 170 
is accessed should correspond to the method used _ to 
create it on the 180 originally assuming that the file 
originated on the 180). 


AS: 6/12 ASCII 


A170 6712: ASCII character files (used by XEDIT and most 
SES utilities) are converted to 180 8/8 ASCII with Block 
Type = System (Unblocked) and Record Type = Variable 
(RT=W). The 170 togical record structure EORs are 
dropped. 


A383 8/12 ASCII 


170 87122 ASCII character files are converted to 180 878 
ASCII with Block Type = System (Unbtocked) and Record 
Type = Variable ({(RT=W). The 170 logical record 
structure (EORs) are dropped. 


D543. Dispiay Code 64 Character Set 
170 Display Code character files are converted to upper 
case 180 8/8 ASCII with Biock Type = System (Unbitocked) 
and Record Type = Variable (RT2#W). The 170 logical 
record structure EQRs are dropped. 

Example of GET command: 


LIU, USt(FABsNVE) » PASFABX 9 A271369 PR=73E08802. 
GET» TEXTs TEXT612 »99NVE 9 Abe: 


Note: When the GET command is used on the Simulators the 


file specified by the "pfn* parameter must be a 
170 file which is local to the simufator job. 


1.7.1.4 REPLACE A_170_ Permanent File Erom_.189 


The REPLACE command transfers a copy of a180 tocai file to a 
permanent fite on the 170-4 If a permanent file of the same name 
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does not exist for the specified user (catalog)» a direct acccess 
permanent fite is created. If a direct access permanent file of 
the same name afready exists in the catalog and the file can be 
attached with write mode then the existing direct access file is 
overwritten with the File from the 180. If an indirect access 
permanent file of the same name already exists in the catalog 
then the indirect access file is replaced by the file from the 
180. An existing indirect access file will got be changed to a 
direct access file if the user's indirect access file size Ifimit 
is exceeded. The NOS/VE command processor must be in HCS mode 
(HCS command issued) in order to use the REPLACE command. All 
parameters on the REPLACE command are positional. Qnty the '"lfn! 
parameter is required. A LINK_USER command must be issued (for 
the 170 family on which the permanent file resides) prior to 
issuing the REPLACE command. The format of the REPLACE command 
is: 


REPLACEs Ii fnspfn»spwsunsfmscae 


1fn (local file name) - This is the name of the focal NOS/VE 
file which will be transferred to a permanent file on 
the 170. . 


pfn (permanent file name) - This is the name of the 170 
pernanent fiie that is to be created or replaced. If 
this parameter is omitted then tifn! will be used for 
the 170 permanent file name. 


pw {password) - This is the password that wiil be associated 
with a newly created direct access file or which is used 
to gain access to an already existing direct or indirect 
access permanent file. 


un Cuser name) -—- This is the user name (catalog) on which an 
existing 170 direct or indirect access file resides. 
This parameter is iltegal if the file does not exist. 


fm (famity) - This is the family on which the 170 permanent 
fife is to reside. Currently the only 170 Family on the 
$2: Dual State system is NVE. 


ca (converion aitternatives) - This parameter specifies the 
type of conversion that is performed by the IRHF = on 
files transferred from 180 to 170. If this parameter is 
onitted then a defauit of B60 will be assumed. Values 
for this parameter ares: 


B603 Basic Binary 


The lower 60 obits of each 64 bit 180 word are 
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B563 


A63 


A8: 


D643 


transferred to the full 60 bits of each 170 word. The 
upper 4 bits of each 64 bit 180 word are discarded. The 
180 file which is to be transferred should be written by 
BAM with Block Type = System (Unblocked) and Record Type 
= Undefind (RT=#U). The file is transferred to the 170 
as a single togical record (i.e. files with multiple 
ERs cannot be created on the 170 from the 180). 


[180 Binary 


Groups of 7 contiguous 8 bit bytes from the 180 will be 
transferred to the Jlower 56 bits of each 170 word (i.e. 
the first 7 8 bit bytes from the first 180 word go to 
the tower 55 bits of the first 170 words the 8th 8 bit 
byte of the first 180 word and the first 6 8 bit bytes 
from the second 180 word go to the iower 56 bits of the 
second 170 word etce). The way that the 180 file to be 
transferred is created does not matter because the 
entire structure of the 180 file is preserved on the 
170. The file is transferred to the 170 as a single 
logical record. 


6/12 ASCII 


A 180 8/8 ASCII character file with Block Type = System 
(Jnblocked) and Record Type = Variable (RT#W) is 
converted to a170 6/12 ASCII file Cused by XEDIT and 
most SES utilities). The File is transferred to the 170 
as a single logical record. 


8/12 ASCITL. 


A 180 8/78 ASCII character file with Biock Type = System 
(Unblocked) and Record Type = Variable {(RT#W) is 
converted to a170 8/12 ASCII file.e The 170 file can be 
routed directiy to the printer with the 170 ROUTE 
command with the EC2A9 parameter, The file is 
transferred to the 170 as a single togical recorde 


Display Code 64 Character Set 
A 180 8/8 ASCII character file with 8!ock Type = System 


(Unblocked) and Record Type = Varlable (RT=W) is 
converted to a 170 Display Code file with lower case 


characters mapped to upper Cas@es ASCII. special 
characters that do not have a Display Code equivalent 
are converted to Dispiay Code blanks. The file is 


transferred to the 170 as a single togical record. 


Example of REPLACE command: 
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LIUs US2(FABsNVE) »s PA@FABX 9 A=71369PR=73E08802. 
REPLACE sMYFILEsFILEB5699aNVEsB 566 


Note: When the REPLACE command is used on the Simulators the 
file specified by the 'pfn* parameter will become a 
170 File which is local to the simulator jobs 


1.71.5 Example Jobs Representing Phase A/ZB Library Creation/Modif 


General Notes 


o The HCS and SCL commands have been deleted. 

o Comment capability within command tine is not currently 
available 

0 HCS comment tine format (starts with singtie quote) not SCL 
compatible . 

09 The 860 conversion parameter on the GET command is utilized to 
indicate that the A170 file is to be transferred to NOS/VE 
without conversion 

0 The NOS/VE job command stream must use NOS 6712 ASCII Cor 
display code subset) . 

9 The B55 conversion parameter on the REPLACE command is 
utilized to indicate that the 64 bit oriented NOS/VE file is 
to be transferred to the A170 without truncation of data. 56 
C180 data bits are stored in each 60 bit A170 word. 

0 The 856 conversion parameter on the GET command is utilized to 
indicate that an A170 file with 56 C180 data bits per 60 bit 
A170 word are to be transferred to NOS/VE as a 64 bit. oriented 
NOS/VE file. . 

o REPLACE can now be used to replace an existing A170 file 

o GET and REPLACE now allow specification of alternate user 
names 

o Parameters to programs must be delimited by quote marks. 

o0 Files routed from 170 must contain valid 6712 ASCII datae No 
previous Kiudges (% for _) are supported. 


1.721.521 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE TT ON Al70 NOS 
Notes 


0 C€tG0170 is A170 permanent File name for file containing object 
text (in CI. data mapping) for modules to be inciuded in the 
librarye: 

o CITEXT180 is NOS/VE tocal file name for file containing object 
text {Cin CI data mapping) for modules to be included in the 
(ibrar ye: 

o [ITEXT180 is NOS/VE tocal fite name for file containing object 
text (in II data mapping) for modules to be inciuded in the 
library. 
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0 LIBRARY180 is NOS/VE tocal. file name for the tibrary being 
created. 

o IL18170 is A170 permanent file name for file containing the 
librar yei 


NOS7VE Job Commands 
LIU» USER={ JI nsNVE) » PASSWORD=jimxs ACCOUNT=notusedsPROJECT=notused 


GETscitextl B0scigDL705»sNVEsB50 
EXECUTEs,s 'citextl3 Osiitext180'ss,,CITOII 
EXEC UTE ss 59 sCOL 

ADDs OBJECT_FILE#iitext180 
GENERATEsLIBRARY*1ibrary180 

QUIT | 
REPLACE» 1librar y180si11b1705s»NVEs856 


Le7ele25e22 YODIFY A PREVIGUSLY SAVED. OBJECT LIBRARY 
Notes 


o ILIB170 is A170 permanent file name for file containg the old 
library 

09 LIBRARY1L380 is NOS/VE focal File name for fille containing the 
oid library 

o €M0D170 is A1L70 permanent file name for file containing CI 
object text for the new module 

o NEWCIMODULE is NOS/VE tocal file name for file containing CI 
object text for the new module 

o NEWIIMGDULE is NOS/VE local file name for file containing II 
object text for the new nodule 

o NEWLIBRARY is NOS/VE tocal fite name for the tibrary being 
created 

NLI3170 is AL70 local file name for new tibrary 


NOS/VE Job Commands 
LIUsUSR=( jinsNVE)>PASSWORD=jimx»sACCOUNT=notusedsPROJECT=notused 


GETstibraryl8O0s,itibl70s»ssNVEs856 

GET snewcimodulescmod1 7059» »NVE»s860 
EXECUTEs»s *newcimodulesnewiimodule's»s»sCITOII 
EXECUTEs»s 59 sCOL 
ADD»slibraryztibrary180 
REPLACEsOBJECT_FILE=newiimodule 
GENERATEsLIBRARY=newlibrary 

QUIT 
REPLACEsnewlibrarysniibl70sxs»NVE»s856 
QUIT 
REPLACEsnewlibrarysntibl70»s»NVE»B56 
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127212523 USAGE OF NOS/VE LOADER 
LIMITATIONS 


~ The filels) specified by the FILE parameter on the EXECUTE 
command may not be object library files. 


- The program optton PRESET has no effect since the file system 
does not yet support presetting. 


PROCESS 


Create an object text file by compiling a program in reat state. 
Then perform the Following steps in virtual state: 


- Use the SET_OBJECT_LIST command to specify necessary 
libraries. 


~ Acquire any necessary tibraries (which are not quoted in text 
embedded directives) by either: 


o Creating the library file via the object library generator 


ae 
o Staging the tJibrary file from real state to vitual state 
using the GET command {with B56 conversion mode 


specified). 


- Stage the object text file from real state to virtual state 
using the GET command (with B60 conversion mode specified). 


~ Convert the object text file from the CI data mapping to MII 
data mapping by executing the CITOII utility. 


- Load and execute the program via the EXECUTE command. 


- Stage the toadmap from virtual state to real state (for 
printing) by using either: 


o The REPLACE command (with AS conversion mode specified) if 
running on the simulator. 
or 
o The JMRGUTE command if running on the hardware. 


EXAMPLES 


The foll3owing is an exampte command sequence for executing a 
program not requiring any tibraries for loading: 


Assumptions: ali modules to be toaded are contained on the {real 
state) permanent file 'citxtrs!. 
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LINK USER sUSER=( jl nasNVE)DsPASSWORD=jilnxs es 
ACCOUNT2notusedsPROJECT=notused 
GETscitxtvsscitxtrss»s»NVE»s3860 
EXECUTEss*citxtvss,iitext!sssCITOII 
EXECUTEs,iitext»s*program. parameters! 
JMROUTEsnotusedsLOADMAPsPResREMOTE 


A NOS/VE tlibrary containing the CYBIL runtime procedures can be 
obtained via the following: 


LINK _USER sJSER=( jinasNVE)sPASSWORD2=jinxsACCOUNT=notuseds.» 
PROJECT=notused 
GETsCYBILISsCYBIILBssDEVI»NVE»8 56 


The following is an exampfe command sequence for executing a 
program requiring libraries for loading: 


Assumptions: the (real state) permanent file 'citxtrs’ contains 
object text generated by the CYBIL CI. compiler. The compiter 
modules reference procedures contained on the user library 
Imylib®t and the CYB8IL run-time tJibrary.. These ftibraries have 
been. generated in virtual state and saved in reat state. 


LINK _USER sUSER=( jinasNVE)»sPASSWORD= jinxys ss 
ACCOUNT2notuseds PROJECT=notused 

GET» CYBILIBsCYBILIBs»s sDEVIsNVEs356 © 

GETsmytlibsnylibss»s»sNVEs356 

SET_OBJECT_LISTs»ADD=mylib 

SET PROGRAM_OPTIONS sMAP_OPTIONS =(BxEaX95) 

GETscitxtvsscitxtrsss»NVEs360 

EXECUTE sstcitxtvs,s,iitext's,,CITOLI 

EXECUTEsiitexts program parameters! 

JMROUTEsnotusedsLOADMAPsPRsREMDTE 


Le721250% DIFFERENCES BETWEEN PHASE C (BUILD M) AND PHASE A/B (8UI 

Notes? 

1) The status! column indicates whether the command/procedure 
is unchanged from Phase A/Bs modified from Phase A/B or not 
available in Phase A/B (new in Phase C). 


2) Footnotes are numbered within each section. 


3) The foltowing summarizes the condition code ranges currently 
assigned to NVE. 


Common Modules 99000 = 99999 
Common Code Gener ator 89000 — 82999 
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4. 


Condition 


1 
160,000 
170000 
180%000 
1902000 


2003000 | 


210399000 
2209000 
2302000 
240,000 
2502000 


260,000 


2702000 
2805000 
2902000 
3005000 
310000 


3209000 © 
3003000. 


310000 
5202000 
3302000 
3403000 


59509000 - 


5602000 


970,000 


530%000 


39903000 — 


600900 
4105000 
6202000 


Support 


Code 


1599999 
1699999 


1799999 
1899999 
1993999 
2099999 


2199999 


2299999 
2399999 
24939999 


~—2599999 


2699999 
2799999 
2899999 
2999999 
3093999 
3193999 
3299999 


* 5099999 


5193999 


5299999 


5399999 
5493999 
5593999 
5699999 
5799999 
58959999 
59939999 
6099999 
61939999 
6299999 


of 6-12 


by Poy ee om oF MH SD 


Product 


Identifier Product Name 


Reserved 


Basic Access Methods 
Command Language 

Job Management 

Loader . 

Memory Management 
GQperating System 
Permanent File Management 
Program Management 
Resource Management 
Operator Facility 

User Administrator. 
Interstate Communication 
Remote Host Facility 
Object Code Utilities 
Deadstart/Recovery 
Maintenance Services 


Advanced Access Method 
ALGOL 

Assembly Language 

APL 

BASIC 

Conversion Aids System 
COBOL 

CYBIL 

FORTRAN 

PASCAL (Wirth) 

PL/1 

Sort Merge 

SYMPL 


ASCII from the consote (K display) causes 
the following changes? 


TRANSLATEO_.TO_ 


(reversed /) 


(underscore) 


IN@UT_ TRANSLATED. TQ 

7{ £ 

4) ] 

1+ > 

/- < 

f= P) 

/* ' (single quote) 
4/ | 

I» 3 

YA to 7Z a- z (lower case) 
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1.0 DUAL STATE NOS/VE- DEADSTART 
127012524 DIFFERENCES BETWEEN PHASE C (BUILD M) AND PHASE A/B (BUI 


(The major incompatibitities with earlier systems are 
characters for 3; and '. To get a semicolons type /6s t 
a !' (single quote)» type /* 


example 

ex uutl /* bulk 2/* /6 tstatus 
is 

ex uuti toulk' 35 tstatus 


1.7012524-1 Phase C_- Command Eunctions 


Evnection_ atatus 
$M0D new 
$C HAR new 
$CLOCK new 
$DATE new 
SFNAME new 
INTEGER new 
$NAME. new 
$ORD new 
$REAL new 
$STRING new 
$STRLEN new 
S$STRREP new 
$SUBSTR new 
$TIME new 
$VAR new 
S$SPECISIED new 
$SET_COUNT new 
S$VALUE_COUNT new 
$RANGE new 
$DEBUG_MODE_ON new 
SPARAME-TER_LIST new 
SPARAMETER new 


1e7ole5e4e2 Phase C_-_System Access Conmands 
Commands. atatus 
Link User Phl unchanged 
1.7012554%e3 Phase € = Resource Management 
Command_ Status 
REQUEST_TERMINAL NOS- ¥*1 


*1 The REQUEST_LTERMINAL. command does not property assign a 


for 
o get 


file 
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Le7el252423 Phase C - Resource Management 


to a terminal. <A RMPSREQUEST_TERMINAL cail issued from the 
same task that accesses the terminal via BAM must be used to 
assign a file to a terminal device, 


Files assigned to a terminal device can be accessed yia the 
following BAM requests: 


AMPS OPEN 
AMPS$GET_NEXT 
AMPS$GET_DIRECT 
AMPSGET_PARTIAL 
AMPSPUT_NEXT 
AMPSPUT_DIRECT 
AMPSPUT_PARTIAL 
AMPS$FLUSH 
AMPSCLOSE 


oooo0ooo 6 8 


All terminal. attributes can be specified on the 
RMPSREQUEST_LTERMINAL call but oaniy the following are 
operational? 


auto_input 
format_effectors 
transparent mode 
pront_file 
prompt_string 


ooo 0 © 


Lle7ol.5e4e% Phase CC _- Eile Management 


Command | atatus 
FILE new 
COPY new 
DUMP_FILE new 
COMPARE new 


1.7012554%.5 Phase C_- Permanent Eile Management 


Command. atatus 

HCS GET unchanged 
HCS REPLACE unchanged 
DEFINE unchanged 
ATTACH unchanged 
PURGE unchanged 
CHANGE unchanged 
PERMIT unchanged 
DELETE. PERMIT unchanged 
DEFINE_CATALOG unchanged 


PURGE_CATALOG unchanged 
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Le 701052425 Phase C —- Permanent File Management 


DELETE_CATALOG_PERMIT new 
PERMIT_CATALOG new 


12701250425 Phase C_-_SCL_ Statements and Procedures 


*1 


¥*2 


*3 


#4 


Command. atatus. 
PROC/PROCEND new ~ *5 
SET_COMMAND_LIST new. 
DISPLAY_COMMAND_LIST new 
REPEAT/UNTIL new 
WHILE/WHILEND new 
DECLARE_VARIA3LE unchanged 
REMOVE_VARTABLE unchanged 
BLOCK/3LOCKEND new 
LOOP/LOOPEND new 
FOR/FOREND new 
IFZELSEIF/ELSESIFEND new 

CYCLE new 

EXIT new 

INCLUDE: *5 
COLLECT_TEXT x4 

DISPLAY VALUE unchanged 
EXIT PROC new 

ACCEPT unchanged 

90 new 

HCS deleted - ¥*1 
SCL deleted —- *1 
change HCS$ variable modified ~- ¥*2 
display HCS variable modified - *3 


The SCt interpreter will now be in control to process 
commands when a job is initiated. HCS commands will be 
automatically passed to the HCS command interpreter. 
When SCL “comes up" in a job it displays a banner contaning 
tne OS names date and time. The value of these commands are 
controijed by integration. 
The new form of this commands is as follows: 

LNS variable name = new_value 
The new form of this command is as Follows? 

LNS variable _name 
For some time now the default value for the collect text 


command's UNTIL parameter has been ( ) rather than ** as 
described in the ERS. This was because it was not possible 
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LeTele5 0426 Prhase C - SCL Statements and Procedures 


*5 


to enter from the console {on the 52) a line to be 
interpreted on the 180 side that began with an asterisk. 


Since this problem was alleviated in buitd L the caltect text 
command now defaults the UNTIL parameter to **. 


It is now possible to initiate the asynchronous execution of 
tasks within an SCL PRIC or File of INCLUDEd commands and 
have processing of the PROC or file of commands return 
control before the asynchronous tasks have finished. 


Le7ole504e7 Phase C_-_ Object Code Maintenance 


Command gtatus 
CREATE_OBJECT LIBRARY unchanged 
DISPLAY LIBRARY unchanged 
SELECT _DISPLAY_LEVEL unchanged 
ADD unchanged 
REPLACE unchanged 
COMBINE: unchanged 
CREATE_MODULE new 
BIND_MODULE new 
DELETE unchanged 
CHANGE unchanged 
SATISFY new 
REORDER unchanged 
GENERATE unchanged 
QUIT unchanged 
CI to I1 Conversion unchanged 
DEFINE. PROGRAM new 


12701250423 Phase € - User Services 


*1 


Command. Status 

DISPLAY_LOG new — ¥*1] 
HCS ZDIS deleted 
HCS FMDAYFIL deleted 


NOS/VE now creates global togs and atiows ASCII togs to be 
displayed. 


The system tog can be displayed at the console via the 
following command: 


EXECUTE sss 9sSDZSe TASK NAME#taskl 


A job tog can be displayed at the consote via the following 
command: 
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EXECUTE sssesZDIS»TASK_NAME=task2 


The following differences exist between the build M 
DISPLAY_LOG and the description in the 9/26/80 NOS/VE command 
interface ERS? 


0 8 6upOon. = <local_file name> instead of output = 
<Pile_ refer ence> 


o 6©type = <systemisys: job> instead of type 2 
<systems accountiengineering: 
statistics: jobi job _statistic> 


1.701+524.9 Phase € = File Routing 
Command. atatus 
HCS JMROUTE ¥1 
#1 <JMROUTE of the LOADMAP is no longer requirede. The LOADMAP 


will appear on the standard output file by default. 


107012504010 Phase © —-_ Progran Execution 


*i 


*2 


Command. atatus 
SET_LOBJECT_LIST unchanged 
SET_LPRIGRAM_DPTIGNS *1 
DISPLAY _PROGRAM new 
EXECUTE: new — *2 
"name cali" new 

HCS EXECUTE *3 
Library Loader. unchanged 
PUSH. DEBUG _ MODE unchanged 
POP_DEBUG_MODE unchanged 
SET_DEBUG_MODE. unchanged 
SET L-DEBUG_RING new 
TSTATUS deleted 
TMTERM deleted 


All parameters on SET_LPROGRAM_OPTIONS are now supported 


Programs previously toaded by the NOS/VE loader via the HCS5S 
EXECUTE must now utilize the SCL EXECUTE. The parameter 
Passing mechanism is different.» The template for a NOS/VE 
program decitaration is the following: 


PROGRAM XxX (parameter :pmt$program_parameters; VAR 
status: ost$status) 
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*3 


le?» 


where omt$program_parameters is defied in deck PMDPARM to be 
SEQU*).: 


In general the parent and child tasks must have some 
convention regarding the contents of the sequence. If the 
parent task is SCL (as will be the case when the SCL command 
EXECUTE is processed) then the contents of the sequence is by 
convention of type: 


cittparameter_list contents 


The DEBUG option on the HCS EXECUTE command is no longer 
supported. DEBUG mode must be activated via the SCL. command 
SET_DE3UG_MODE. 


The NOS/VE tloader can no tonger be activated by the HCS 
command EXECUTE. The SCL command EXECUTE must be used to 
load programs residing on object fies (via the NOS/VE 
loader). 


The HCS command EX (atso known as EXEC) is no tlonger 
supported. HCS "programs" opreviosity toaded into the HCS 
program library must now be imptemented as [XDCts#GATE] 
procedures which are bult on the fibrary XLJBBB. 


Existing HCS programs have been converted and run from the 
XLJBBB ftibrary. The following list shows the NOSVE commands 
corresponding to the previous HCS commands. 


oid form new form 

EX RHINPUTs»sA EXECUTEs »992RHPSINPUTsTASK_NAME=A 
EX RHOJTQ890A EXECUTE s » 99s RHPSOUTPUTs TASK NAME=8 
EX CITO{LI "param? EXECUTEsstparamt»sss,CITOILI 

—EX COL EXECUTE s 9595 »COL 

EX OBJLIST 'param!? EXECUTEss*param'!»s,,0BJLIST 

EX IFEXECes»sA EXECUTE s »5s95IFEXECs TASK _NAME=C 
1e5e4e1l Phase C_ - Job Management. 

Command atatus 

SUBMIT new 

DISPLAY_JGB_LSTATUS new 

DROP_JOB new 

PRINT new 

DROP_FILE new 

DISPLAY_PRINT_STATUS new 

HCS JMEXIT #2 


HOS JMDROP *2 


1-22 
12/76/79 
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Le70el.5e4el1ll Phase 


C —- Job. Management 


*1 


*2 


JMEXIT is no longer required to terminate a batch job. It is 


required to switch an 


interactive 


{The SCL command LOGOUT can also be used.) 


JMDRDP of an executing job will 
DROP_JO3 command must be used.s. 


longer 


1.7.1.524e212 Phase C_- Command Processing 


Procedure. 


CLPSSCAN_PARAM_LIST 
CLPSTEST PARAMETER 
CLPSGET_XEYWORD 
CLPSGET_LSET_COUNT 
CLPSGET_VALUE COUNT 
CLPSTEST_LRANGE 
CLPSGET_VALUE 
CLPSDECLARE_VARIABLE 
CLPSREMOVE _VARTABLE 
CLPSREAD_VARIABLE 
CLPSWRITE_VARIABLE 
CLPSSCAN_COMMAND_FILE 
CLPSEND_SCAN_COMMAND_FILE 
CLPSSCAN_COMMAND_LINE 
CLPSPUSH/POP COMMAND LIST 


atatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new 


Lle7o1e524e13 Phase _ C_ - Message Generator 


Procedure 


OS PSFORMAT_MESSAGE 
DSPSSETLSTATUS ABNORMAL 


OSPSAPPIEND_STATUS _PARAMETER 


Status 


unchanged 
unchanged 
unchanged 


127012504014 Phase C_- Device Management 


Preocedure_ 


RMPSREQUEST_UMASS_STORAGE 
RMPSREQUEST_TERMINAL 


Status 


new 
? 


10701.564015 Phase C = Queued File Management 


Procedure. 


JMPSROUTE 
JMPSQOSTATUS_TERMENAL_FULL 
SMPSQSTATUS_FAMILY FULL 


aiatus 


unchanged 
new 
unchanged 


user back to A170 NOS. 


works The SCL 
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1.0 DUAL STATE NOS/VE DEADSTART 


LeZole0504015 Phase C ~ Queued File Management 


JMPSQSTATUS_ FILE FULL 
JMPSQCOUNT_TERMINAL 
JMPSQCIUNT_FAMILY 
JMPS$OROP_QFILE 
JMPSDIVERT TERMINAL 
JMPSDIVERT_LFAMILY. 
JMPSDIVERT_LQFILE 
JMPSALTER_QFILE 


new 
new 
unchanged 
unchanged 
new 
unchanged 
new 
unchanged 


Le7ole2504%016 Phase C_-_ Program Execution 


Procedure. 


PMPSEXIT 

PMPSEXECUTE 

PMPSTERMINATE 
PMPSAWAIT_ TASK _ TERMINATION: 
PMPSMODULE_TABLE_ADDRESS 
PMPSENTRY_POINT_TABLE_ADDRESS 
PMP SPUSH_JGB_DEBUG_MODE 
PMPSPOP_JOB_DEBUG_MODE 
PMPSSET_JOB_DEBUG_MODE 
PMP$JOB_DEBUG_MOQDE_ON 
PMPSPUSH_ TASK _DEBUG_MODE 
PMPSSET_TASK_DEBUG_MODE 
PMPSTASK_DEBUG _MODE_ON 
PMPSSET_DEBUG_RING 
PMPSDESUG_RING 
PMPSCHANGE_DEBUG_LIBRARY_LIST 
PMPSPOP_TASK_DEBUG_MODE 


Status 


new 
new 
new 
new 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new 
new 
new 
unchanged 


1.70105e4e17 Phase _ €C_- Progran Communication 


Proceduce_ 


OSPSAWAIT_ACTIVITY_COMPLETION 
PMPSDEFINE_ QUEUE 
PMPS$REMOVE_QUEUE 
PMPSCONNECT_QUEUE 
PMPS$DISCONNECT_QUEUE 
PMPSSEND_TO_QUEUE 
PMPSRECEIVE_FROM_QUEUE 
PMPSSTATUS QUEUE 
PMPSSTATIS_QUEUES DEFINED 
PMPSGET_QUEUE_LIMITS 


status 


new 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


127.125.4218 Phase _C_- Condition Processing 


Preoecedure_ 


atatus 
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oe Fe 808 78 


127012504019 Phase C_-_ Program Services 


wre rem rem ee EA Me Mt Mi te ed Mah 


PMPSESTABLISH_CONDITION_HANDLER 
PMPSDISESTABLISH_COND_HANDLER 


PMPSCAUSE_ CONDITION 
PMPSCONTINUE_TO_CAUSE 
PMPSTEST CONDITION _HANDLER 


PMPSVALIDATE_PREVIQUS_SAVE_AREA 


PMPSSETLEXECUTION_INTERVAL | 
PMPSESTABLISH_DEBUG_CFF 


Procedure 


PMPSGET_TIME 
PMPSGET_MICROSECOND_ CLOCK 
PMPSGET_TASK_CP_TIME 
PMPSGET_DATE 
PMPSGET_LUSER_IDENTIFICATON 
PMPSGET_ACCOUNT_PROJECT 
PMPSGET_JOB_NAME 
PMPS$SGET_JOB_ID 
PMPSGET_JOB_MODE 
PMPSGET_PROGRAM 
PMPSGET_TASK_ID 
PMPSMANAGE_SENSE_ SWITCHES 
PMPS$GET_OS_VERSTON 
PMPSGET_PROCESSOR_ATTRIBUTES 
PMPSDEFINE_DEBUG_ENTRY 
PMPSGET_DEBUG_ENTRY 
PMPSMODIFY_DEBUG_LENTRY 
PMPSREMOVE_DEBUG_ENTRY 


207012524%.20 Phase_C_- Logging 


¥*1 


Le7ole5e4e21 Phase C_- File Management 


Proceduce_ 


PMP$LOG 

PMPSLOG_ASCII 
PMP$DISABLE_ATTACHEs_TO_LOG 
PMPSENABLE_ATTACHES_TO_LOG 
PMPSGET_LOG_CONTROL 
PMPSTERMINATE_LOG 


fogs are now gicbal 


Procedure_ 


Sequential Access 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new 
new 
new 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new 
new 
new 
new 
new 
new 
new 
new 
unchanged 
new 
new 
new 
new 


Status 


*1 

new 
new 
new 
new 
new 


status 


*1 


Ate Nt en i te i sid en ct in Ae ete Mi Mtn te it Eh Bete Keg tad ph Btn ini en Kd dad 
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127012504021 Phase € —- File Management 


*2 


#3 


Byte_Addressable Access 
Record Access 

Segment Access 

W System Specified 
WiUser Specified 
U_System Specified 
U_User Specified 
F_System Specified 
F_User Specified 


AMPSDESCRIBE_NEW_FILE 
AMPSFILE. 
AMPSGET_FILE_ATTRIBUTES 
AMPSFETCH 

AMPSSTGORE 

AMPS$COPY_FILE 

AMPSRENAME 
AMPSRETURN_LOCAL_ FILE 
AMPSOPEN- 

AMPSCLOSE 
AMPSFETCH_ACCESS_ INFORMATION 
AMPSSKIP 

AMPSREWIND 
AMPSWRITE_LEND_PARTITION 
AMPSGET_NEXT 

AMPSGET _DIRECT 
AMPSGET_PARTIAL 
AMPS$GET_PARTIAL DIRECT 
AMPSPUT_NEXT 
AMPSPUT_DIRECT 
AMPSPUT_PARTIAL 
AMPSPUT_PARTIAL_DIRECT 
AMPSSEEK_DIRECT 
AMPSGET_SEGMENT_POINTER 
AMPSSET_SEGMENT_EOI 
AMPSSET_LSEGMENT_POSITION 
AMPSSETLLOCAL_NAME_ABNORMAL 


AMPSSETLFILE_LINSTANCE_ABNORMAL 


AMPSACCESS_ METHOD 
AMPSFETCH LFAP_POINTER 
AMPSSTIRE_FAP_POINTER 


unchanged 
¥] 

? 
unchanged 
new 
unchanged 
new 
unchanged 
new 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new 

new 

new 

unchanged 
unchanged 


unchanged 


#1, *5 
unchanged 
¥l,y *6 
unchanged 
*1 
unchanged 
¥l,y *3 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new 

new 

new 

new 
unchanged 


*1 user specified blocking is now supported 


AMPSREWIND 


The WAIT parameter on the procedure call 


AMPS$PUT_ PARTIAL 


PUT_LPARTIAL with the TERM_OPTION = AMPCSSTART does not 


anew record. 


(2?) 


is not supported. 


start 
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*4 AMPSSKIP 
If the number of units to skip = 0 and the file is positioned 
mid-unit the file will renain. positioned mid-unit. 


*5  AMPSGET_NEXT 
A GET_LNEXT with a working storage ftength = 0 will return an 
undefined file position. A request of zero tength is invalid 
and will result in abnormal termination in later builds. 


*6 AMPSGET_PARTIAL 


A GET_PARTIAL of record type = undefined never returns file 
position of end-of-record. 


1.721.504e22 Phase C_- Permanent File Management 


Procedure. itatus 

PFPSDEFAINE unchanged ~— ¥*1 
PFPSATTACH unchanged — *1 
PFPSPURGE. unchanged —- *1 
PFPSCHANGE unchanged - ¥*1 
PFPSPERMIT unchanged — ¥*1. 
PFPZSDELETE PERMIT unchanged — *1 
PFPSDEFINE_ CATALOG unchanged — ¥*1 
PFPSPURGE CATALOG unchanged ~- #1 
PFPSPERMIT_CATALOG unchanged — *1 
PFPSDELETE_CATALOGG_PERMIT unchanged ~- ¥1 


*1 - Build M Permanent File Program Interface Deficiencies 
1. GET»SAVE and REPLACE are not implemented (non-R2 features). 


Be Since no validation facility exist at Build Ms there is no 
official way for master catalogs to be created. The system 
job does» howevers, create a master catalog for itself. 
Therefore the system job and other jobs with the same family 
name and user name (familyl»s», userl) can perform 180 permanent 
file operations.» 


32 Permanent files on the "180 side” are only permanent until a 
NOS/VE deadstart. 


4 Usage_sefiections and share _sefections may be specified an 
the ATTACH request but they will not be honored. Files will 
never appear busy and hence exclusive access is not 


possibie. 


5 ATTACH returns an existing tocal file rather than producing 
an error status. 
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6. 


7. 


Bs 


Je 


10. 


ll. 


DEFINE makes an existing tocal: file 


producing an error statuses 


permanent 


rather 


than 


It is possibse to create both a catalog and a file with the 
same name ata particular tevel of the catalog tree. 


The WAIT parameter 
 PFCSENO_WAIT 


Blank names 
Passwords are not validated for ATTACH» 


Permanent. 
has expired. 


for 


is specified. 


ATTACH 


is always 


treated 


as if 


in the GROUP parameter produce an error statuses 


1.721.524.23 Phase C_ -_ Memory Management. 


#1 


MMPSADVISE_IN 
MMPSADVISE_OUT 


MMPSADVISE_OUT_IN 


MMPSWRITE_MODIFIED_PAGES 


MMPSCREATE_SEGMENT 
MMPSDELETE_SEGMENT 


MMPSOPEN_SEGMENT 

MMPSCLOSE_SEGMENT 
MMPSSYSTEM_CREATE_SEGMENT 
MMPSSYSTEM_DELETE_SEGMENT 


MMPSSTORE_SEGMENT_ATTRIBUTES 


MMPSSYSTEM_LDELETE_ALL 


MMPSFETCH_SEGMENT_LATTRIBUTES 


MMPSVERIFY_ACCESS 


MMPSFREE 


MMPSSTORE_LSEGMENT_ATTRIBUTES 


MMPSLOCK_PAGES 
MMPSUNLOCK_ PAGES 


MMPSFETCH_PVA_UNWRITTEN_PAGES 


stubs 
procedures 


have 


been 


replaced 


with 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


code to 


1.701.525 BAM BUILD J DEVIATION FROM ERS 


9 


0 


Data_stcuctures 


implement 


PURGE or CHANGE. 


files are never purged because a retention period 


these 


Partition delimiters are neither generated nor recognized 


Data procedures 


amp$describe_new_file 
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As opposed to the ERS» this request is processed each time a 
file is opened regardless of whether the file is new or old. 


amptfiie 
This request can onty be issued once oper file with 
predictable results. If a second amptfile is issued it wilil 
overwrite any attributes supplied via amp$describe_new_file. 
ampSfetch_access_info 
Record_fiength attribute is not returned correctiy. 
Transfer_count attribute not returned correctly. 
Fields error_counts error_status and residual _skip_count are 
not defined. A defauit for these attributes will be 
returned. 
amp$get_segment_pointer 
Pointer _kind fietd of pointer not always returned correctly. 
amp$get_next 
Will oonty transfer the First part of a continuation record 
created via amp$put_partial. 
amp$get_partial 
If record tength is greater than the working storage tength»s 
the working storage area will be overwritten to accomodate 
the record. 
Partiai_get of F type records is not avaitable. 
ampsrewin 
The WAIT parameter on the procedure calf is not supported. 
FAPs 
Cannot pass control to a FAP whose execution bracket is tess 
than 4- 

1.38 QDSOL_INEQRMATION 


To create an Express Deadstart Dump (EDD) tape: 
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1.8 DSDOI INFORMATION 


1) 
2) 
3) 
4) 
3) 


6) 


7) 
8) 


9) 


10) 


Mount scratch tape (ring in) on a 9-track. drive. 
Push D/S button. 

Select U Cutilities) display. 

Select E (&DD) display. 

Set. channel ($2213). 

Set ECUU ($2201luu) 

E = equipment 


C = 1 for 67K drives 
2 for 66X drives 


uu = unit number of the tape drive to be used. 

Answer "non zero inhibits rewind” with a CR. 

Answer "dump number” with a CR. 

Answer "CM/(MB)" with the size of memory you want to dump 
{in megabytes) -6 for build M5. 

Note: This display nay not appears depending on the 


version of EDD being used. 


Answer "dump controltware™ with a CR. 


To create a listing of the EDD tape: 


1) 


2) 


3). 


REQUEST sDUMPaNTsD=PEsFzSaLB2KUsPO2ReVSNayour choice. 
GETsDSDI/UN=DEV1. {On S/N 101.) 
or 
GETS, OSDI/IN=DEV1L.~ (On $2.2) 
Create DOSDI directives file: 
A OSDI directive file should include the following: 
IOUMR,. 
PROMR. 
MEMMR. 
PRORF. 


Wafirst_byte_addressslast_byte_adresssasid. {where the 
First_byte_address and tflast _byte_address are hex byte 
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1.8 DSOI INFORMATION . 


addresses and asid is the asid of the segment to be 
dumped) 


4%) Execute DSDI: 


RFL»69000. 
DSOLT»sMsDsT2*input directives file". 


5) To run (after the first time): 
DSDIsyT=n. 
(Does not read tape again.) 
6) To run interactively: 
Same as aboves except to do W command must first do: 
QUTPUTsLISTFIL. 


7) C170 OSDI information can be found in Chapter 10 of the 
NOS SYSTEM MAINTENANCE: Manual. 


A170 DSDI. info can be found in document ARH3060 -— GID 
for A170 NOS/S2. 
1.9 NAMIAE_INEQRMATION 


Bringing NAM upe 


1) At the system console enter? 
FNC 5s 7700. 
3eNAMs 


2) If IAF is not up at control point l»s enter: 
IAF. 


3) To send nessages to all terminais enter? 
3.CFO4SGsALL»s message, 


Bringing NAM downs: 


1) At the system consoles enter? 
3e.CFD.ADI» NE. 


2) Turn the teletype by the 2550 off. 
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3) To bring IAF down enter: 
1.STOP.. 


1.10 A1ZO_NOS_ SHUTDOWN 


Before leaving the machines it is necessary to bring NOS 
down» If NOS has crasheds a tevei 3 deadstart must be attempted 
{see Section 3.21.8) even if the only reason is to bring NOS 
downe To bring NOS downs do the following: 


1) Enter: 


CHE 

The screen will display: 
CHECKPOINT SYSTEM. 
Enter: carriage return 


2) Make sure no mass storage device has a checkpoint rquested. 
To do this» enter: EsM. If the dispiay shows there are no 
"C"s in the status Fields then all devices are checkpointed 
and you may continue. 


3) Enter: 
STEP. 


4) Push deadstart button. 


Leil INTERIM MEMORY _LINK_ STORAGE MOVE CONSIDERATIONS 


The following precautions must be taken when running dual 
State with the Interim Memory Link storage move fix (NOS/VE Build 
J6 and associated NOGS/A170 System). 


1) Drop I[RHF170> PASSON and att permanent file partner jobs 
before doing *B8YEVE (via 2.STOP.) 


2) Do not rollout IRHF170» PASSON or permanent file partner jobs 
at any time. 


3) Before doing a CHECKPOINT SYSTEMs drop IRHF170» PASSON and 
all permanent file partner jobs (via 2-eSTOP.) 


4) If the system crashes a NOS/A170 level 3 deadstart is the 
preferred action. If for some reason yos must do an MCU 
recovery (REC command) do the following: 
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- Ciear word 17(8) vias 
996) 
1790. 

~ Enter REC on the MCU console. 

- Finish up in A170 onty mode (i2e.s do not do an UPMYVE) > 
then do afevel 3 deadstart.» If you bring up NOS/VE again 
without doing a tevel. 3 deadstarts, the resuits are 
unpredictable. 


1.12 NOS/VE_INTERACTIVE FACILITY OPERATION 


1212.1 OPERATOR INITIATION 


1) 


2) 


3) 


4) 


To bring up the NOS/VE- interactive facility do the following: 
Bring up NOS/VE (build M™). 

Bring up NOS/A170 networks: 

- FNC5s7700. (may sometimes be skipped) 

- 3.NAM, 

Bring up A170 part of interactive: 

- TAFNVE. (If not yet done) 

When NIUS/VE is ups bring up the C180 part of interactive: 


— KsEXECUTEs»s» ses ITFEXECsTASK_NAMESIFEXEC. 


121222 OPERATOR TERMINATION 


To terminate NOS/VE interactive any of the following may be 


done; 


3.CFGe.DI»AP=TAFi. (3 is the NAM control! point number) 


This is the preferred method. To bring NOS/VE interactive 
back ups you must first do a 3.CFOLEN»AP=TAF. 


3-CFO-DI»sNE. (2 is the NAM control point number) 


This terminates the entire network including IAFsRBF»s etc. 
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1212.23 OTHER OPERATOR CAPABILITIES 


To send a "shutdown warning” to all terminals logged on to TAF 
do: 


3eCFI.ID»,AP=TAF. (2 is the NAM control point number) 
To send a message to ati terminais do? 
3e.0F3.4SGeALL snesage. (2 is the NAM contro! point number) 


PASSON has the abitity to record various types of diagnostic 
information. This capability is: controlled via the sense 
Switches at the PASSGON controft point. To turn a sense switch 
on (off) at control point N do: . 


NeGNSWX. (NeOFFSWX.) 


Where X is the desired sense switch (1 to 6). The PASSON 
default is all sense switches off. It wilt take ae short 
period of time before PASSGN detects a change in a sense 
switch and reacts to it. The sense switches currently used by 
PASSON ares 


swiftch_#_. use 
1 Network Trace 
2 PASSON Logic Trace To Dayfile 
3 Memory Link: Trace To Dayfite 


1.12.24 INTERACTIVE TERMINAL OPERATION 


1.12.41 Validation To Access NOS/VE 


To access NOS/VE via the interactive facilitys your user 


number must be validated to logon to the application named TAF. 
If you get the message ‘ILLEGAL APPLICATION*®* when trying to 
fogons you are probably not vatidated to access TAF. To correct 
this do the Following from the console? 


X»MODVAL. 


KaNe (N is the MODVAL control point number) 
KeUsccc. {cece is your user number) 
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K»AP=ALL. 
KeENDe: 
KeENDa: 


If you get the message "'CONNECTIGN PROHIBITED* it means that 
onty one terminal per user number can be fogged on to TAF at one 
time. This indicates that someone has. changed the network 
configuration - try a different user number until the network 
configuration is changed. 


Lel2e4%e2 Login To NOS/VE 


To initiaittyy login to NOS/VE via TAFs you must cause the first 
logon attempt to fail. This can be done by responding to the 
MFAMILY:" togon promot with something Like: "AsAsA". This must 
be done because the system wil! try to connect the terminai to 
IAF on the first togon attempt no matter what is typed. To 
access TAF do the following on the second *"FAMILY:" prompts: 


suserspasswor dsTAF: 


You can access TAF from IAF by doing "HELLOsTAF"™ or ~oby 
answering TAF to the system prompt "APPLICATION: *. 


1.12.4.3 LTerpinai_ Usage 


1) The stash (/) is a prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered. The full ASCII 
character set (lower or upper case and all. speciai. characters 
can be used). Commands do not need to be ended with a 
period. 


2) A LOGOUT command will. cause the NOS/VE Interactive Job to 
terminate and it*s dayfile (job log) will be returned to the 
A170 For printinge <A new NOS/VE Interactive Job: can then be 
started by responding to the *APPLICATION?® prompt with TAF. 


3) Terminal breaks (Ccontrol!-T and control-?) now work. It is 
possible to terminate a task or to suspend a task and enter a 
new tasx: to process SCL commands. When a break is entereds 
the options availabie to the terminal user are: 

R — resume from point of interruption 


T -— terminate task 


5 —- process SCL commands. To resume execution at the point 
of interruption use the HCS command TMEXIT 
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(temporary). 


12122424 NOS/VE_ Program Access Jo Ihe Terminal 


1) 


2) 


Interactive NOS/VE jobs are able to obtain terminal input 
through the AMPSGET_NEXT or AMPSGET_PARTIAL. program interface 
which. can be used by both task services and user ring 
programs. Interactive programs which use this interface 
should be able to handle both upper and tower case input in 
order to make them more convenient to use in both 64 and 96 
character set modes. 


Interactive NOS/VE jobs can send output to a terminal through 
the CLPSPUT_STND_OUT program interface which can be used by 
both task services and user ring programs. 
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220 S2_DEVELOPMENT_LAB SUPPORT BY INTEGRATION 


What we have established in the tab so far is the following: 


~ A 600 tape capacity tape rack for general use (focated in near 
proximity to the 67X tape drives). If your project would 
like to reserve a section of this tape racks contact Tim or 
myself. 


~ A tape and disk cabinet for storage of system support 
materials which this project wilt manage and keep up to 
date. (If you have been using this cabinet for unauthorized 
storage ~- beware. We have the key to the lock!) More will 
be published about the contents of this cabinet tlaters and a 
cabinet index will be posted in the tab to help tocate where 
things are supposed to be ptaced within the cabinet. This 
cabinet is currently located against th East wall of the tabs 
is 6 ft~ 8 ine talis gray in color and with sliding door. 


~ A twor-tevel documentation rack for system documentation 
listings. This contains the current build compitation 
listing interface deck compilation isting (from modufe named 
QLNOS)» tisting of the NOS/VE PPU routiness system tink map» 
and various assorted PVE listings. This rack is next to the 
tape and disk cabinet at this time. 


- A desk documentation rack for reference manuais and Tom 
McGeets coflection of “how to" goodies. The objective is to 
have this reference information at arm's tength of the 
consoles but it is currently on top of the twor-tevel unit ody 
the East wall. 


At or near the console is a smal! notebook containing the NOS 
System Programmer*s Instants NOS Application Programmer'!s 
Instants and the 180 Instruction codes. 


Feel free to examine and use all of the above materiais while in 
the tab. Qo not remove or abuse any of these materlalss. Please 
notify Tim McGibbon or Mike Carter of any problems or 
deficiencies of these materiais. Leave a note if we are not 
available. 
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APPENDIX A_NOSZVE_ BACKGROUND DOCUMENTS 


1.20 Hardware Overvien 


lel 


1.2 


1.3 


An introduction to CYBER 180 
Ci80 Instant 


Model Independent General Design Specification - ARH1700 


220 NOS Reference Manuals 
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XEDIT V3.0 ~— 60455730 

IAF V1.0 User's Guide - 60455260 

NOS Reference Manual ~— Vol 1s 60435400 — Vol 2» 60445300 
NOS Instant 

NOS Operators Guide - 60435600 

NOS Diagnostic Handbook 

NOS A170 ERS 


NOS A1L70 GID — ARH3060 


NOS/VE Reference Documents 


Program Interface ERS - obtained from Karen Rubey 
Command Interface ERS - obtained from Karen Rubey 


NOS/VE User's Guide - obtained by the foitowing: 
ATTACHs HUS7UN2D AH 

SES»FORMAT [=HUGsL#LIST,LOCALs»TXTFORM 

SES »PRINT LIST 


NOS/VE Procedures = and Conventions ~ obtained by 
SES sMADeLISTPC 


JES Deadstart7180 Operating Procedures 
Listing of ail. NOS/VE- Modules - obtained by 


SESsDEVILISTNVE. See Integration Procedures Notebook 
for details. . 
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Listing of ali NOS/VE type dectarations - obtained by 
doings SES»sDEVL.LISTNVE M=QLNOS.. 


NOS/VE Code Transmittal/PL Maintenance Procedures 
See Integration Procedures Notebook. 
NOS/VE Internal Interface Maintenance Procedures 
Wemo availabie from S.C. Wood. 

Integration Procedures Notebook 
Obtained by: | 


Acquires TPNDOC2/UN2=MDC. SES»PRINTsIPNDOC2. 


4.0 Toots Reference Documents 


&al 


PASCAL~X Interactive Debugger ~ ARH3142 
SES User's Guide - ARH1833 

PASCAL-X Specification. - ARH2298. 

C180 Assembler ERS = ARH1693 
Sinulator ERS — ARH1729 

VESEN ERS =~ ARH2591 

VELINK ERS — ARH2816 

Sinulated I/0 ERS = ARH3125 

Object Code Utilities ERS - ARH2922 


CY3IL. Implementation Dependent Handbook —- ARH3078 


5290 Dual State Cookbook 


To acquire additional copies of this document enter: 


ACQUERE DOCUMEN/UN2=SKT512 
SES «FORMAT IT=DQCUMEN TXTFORM. 
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